home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48_1 / clk.tar / clk.txt < prev   
Text File  |  1990-03-20  |  9KB  |  212 lines
  1.  
  2.                               CLK.TXT File
  3.  
  4.                   (c) Hewlett-Packard Company, 1990.
  5.  
  6.  
  7. OVERVIEW
  8. --------
  9.  
  10. The CLK application keeps the system clock as accurate as possible by
  11. synchronizing the clock with a time standard, and using the accumulated
  12. adjustments with the elapsed time to compute the necessary correction
  13. amount/rate. It is especially useful for applications like navigation that
  14. require extremely accurate times.
  15.  
  16. Adjustments are made relative to the nearest number of 1/2 hour time-zone 
  17. changes. All changes that are multiples of 1/2 hour are assumed time-zone
  18. changes (and ignored in error correction computation); other changes are 
  19. assumed error corrections. For example, a change of +1:35 is assumed to be 
  20. +1:30 time-zone change (ignored) and +:05 error correction (the clock is 5
  21. minutes slow). A change of +1:25 is assumed to be +1:30 time-zone and -:05
  22. error (the clock is 5 minutes fast). Similar examples apply for -1:35 (-1:30
  23. time-zone and -:05 error) and -1:25 (-1:30 time-zone and +:05 error).
  24.  
  25.  
  26. PROCEDURE
  27. ---------
  28.  
  29.  1. Using Kermit, load CLK into your HP 48 HOME directory. (Don't use the HP 48
  30.     built-in TIME SET/ADJST operations while this application is active.) 
  31.  
  32.  2. Press [VAR]{CLK} to access the application.
  33.  
  34.  3. Enter a list containing the minimum interrupt rate and the maximum clock
  35.     deviation allowed, press {C.RST}. (This initializes the application.)
  36.  
  37.  4. If necessary, enter a list containing the current time and date,
  38.     press {C.SET}.
  39.  
  40.  5. Enter the desired adjustment, press {C.ADJ}.
  41.  
  42.  6. Repeat steps 4 and 5 as needed.
  43.  
  44.  7. Press {C.XCT} when the clock is synchronized.
  45.  
  46.  8. Wait a few weeks and then repeat steps 4, 5, 6, and 7.
  47.  
  48.  9. Press {C.STS} to review the status information.
  49.  
  50. 10. Press {C.SSP} to suspend the correction alarm cycle temporarily; press 
  51.     {C.CNT} to continue the suspended correction alarm.
  52.  
  53. 11. Repeat step 3 to cancel the correction alarm and reinitialize all CLK 
  54.     variables.
  55.  
  56. -------------------------------------------------------------------------------
  57. NOTE: If you abort the program, flags that were changed by the program will
  58.       remain changed.
  59. -------------------------------------------------------------------------------
  60.  
  61.  
  62. USER MENU KEYS
  63. --------------
  64.  
  65. The following five programs make up the user interface to this package. Each
  66. will give an error message if the expected input is not found. The error
  67. message attempts to indicate the form of the input expected. Time input should
  68. be in the form HH.MMSSs, and date input should be MM.DDYYYY.
  69.  
  70. {C.SET} - Takes level-1 list containing the current time and date. The clock 
  71.           is set to this time/date. 
  72.                                                                                
  73. {C.ADJ} - Takes from level 1 the amount of adjustment to be applied
  74.           to the current time. A positive amount increases the time and a
  75.           negative amount decreases it. 
  76.  
  77. {C.XCT} - Takes nothing from the stack; tells the correction package that
  78.           the clock is now exactly synchronized with the time standard. If
  79.           this is the first time it has been invoked, then a time base is
  80.           activated and all error corrections from this point on will be 
  81.           accumulated. If this is the second or subsequent invocation, then
  82.           the time base is extended to this point and the necessary
  83.           calculations are done to set up the clock correction package. An
  84.           alarm is scheduled and the correction package will make the needed
  85.           clock corrections from now on. Subsequent invocations will refine the
  86.           accuracy of the corrections.
  87.  
  88. {C.RST} - Takes level-1 list containing the minimum interrupt rate and the 
  89.           maximum clock deviation allowed (both in "time" format). The
  90.           correction package is reset to a virgin state--the time base is
  91.           deactivated, the alarm is removed, and further error corrections
  92.           will not be accumulated (the accumulators are cleared). All
  93.           variables are reinitialized and the directory is reordered. 
  94.  
  95.           Maximum clock deviation specifies the maximum acceptable error for 
  96.           the clock. If the absolute value of the given maximum deviation is 
  97.           less than .01 second, then it is set to 1 second. 
  98.  
  99.           Minimum interrupt rate specifies the minimum amount of time required
  100.           between clock adjustments. If the absolute value of the given 
  101.           minimum interrupt rate is less than 1 second, then it is set to
  102.           1 minute. If the clock cannot be adjusted to accurate time with the 
  103.           given maximum deviation without using alarms at a more frequent rate
  104.           than allowed by the minimum interrupt rate, the correction amount 
  105.           will be increased as needed to ensure that alarms do not occur
  106.           more often. Consequently, the clock may not be as accurate as  
  107.           specified by the maximum deviation. This ensures that alarms are not
  108.           occurring so often that the HP 48 has no time to do anything else 
  109.           (see the "Note" at the end of the documentation).
  110.  
  111. {C.STS} - Takes no input from level 1; provides 3 pages of status information
  112.           about the correction package.
  113.  
  114.  
  115.           All pages have this header:
  116.                   
  117.           Correction status     -N-    (N = 1, 2, or 3)
  118.                                                                 
  119.                            
  120.           All pages have this foot:
  121.  
  122.           prev:<  exit:V  next:>        (Use the respective HP 48 cursor keys.)
  123.  
  124.  
  125.           Display Example (package status), page 1:
  126.             
  127.           Exact initiated(*):
  128.           9.1455  10.301989
  129.           Deviation:   0.000025
  130.           Min rate:    1.0000
  131.             
  132.           The first two lines show the time and date of the first exact
  133.           synchronization. If the display shows "none," an exact has never 
  134.           been done. If there is an (*), then 2 or more exacts have been done 
  135.           and the package is fully activated. If there is no (*), only one 
  136.           exact has been done (errors are being accumulated but no corrections
  137.           are being done yet). The third line shows user specified maximum 
  138.           clock deviation (1/4 second in example). The fourth line shows the 
  139.           user specified minimum interrupt rate (1 hour in example).
  140.  
  141.  
  142.           Display Example (adjustment data), page 2:
  143.  
  144.           Timezones:    0.0000
  145.           Errors:       0.001890
  146.           Timebase:  1718.3909               
  147.  
  148.           The first line shows the total accumulated time-zone changes. The
  149.           second line shows the total accumulated error corrections (18.9 
  150.           seconds in example). The third line shows the total time included in
  151.           the time base (1718 hours, 39 minutes, and 9 seconds in example).
  152.  
  153.  
  154.           Display Example (correction data), page 3:
  155.  
  156.           Next correction:
  157.            11.1644  1.101990
  158.           Repeat:     22.4520
  159.           Adjust:      0.000025
  160.  
  161.           The first line may be either "Next correction:" (the next correction
  162.           time is displayed) or "Adjust suspended:" (the time that the 
  163.           corrections were suspended is displayed). The third line shows
  164.           the repeat interval of the alarm (22 hours, 45 minutes, and 20 
  165.           seconds in example). The fourth line shows the correction 
  166.           adjustment amount (+1/4 second in example).
  167.  
  168.           If a status is displayed for 1 minute with no keys pressed, it
  169.           times out and exits.                   
  170.  
  171.  
  172. {C.SSP} - Suspends the correction alarm (if corrections are active). The status
  173.           report will indicate the time of the suspension. If the {C.SET},
  174.           {C.ADJ}, or {C.XCT} keys are used while the correction alarm is
  175.           suspended, the results may not be correct. ({C.SSP} is found on page
  176.           2 of the menu.)
  177.  
  178. {C.CNT} - Resumes (continues) the correction alarm cycle if corrections are 
  179.           active. Any missed corrections will be made and the next correction
  180.           alarm will be set up. ({C.CNT} is found on page 2 of the menu.)
  181.  
  182.  
  183.  
  184. APPLICATION MENU KEYS
  185. ---------------------
  186.  
  187. The {C.TLS} menu key contains subroutines and variables used internally by the 
  188. application. You do not need to use them to run the application.
  189.  
  190.  
  191. -------------------------------------------------------------------------------
  192. NOTE: The alarm should work regardless of the directory path when the alarm 
  193.       occurs, and it should leave things as they were when it happened. 
  194.       However, if the HP 48 is off when the alarm occurs, it will be turned on
  195.       and left on until the HP 48 times out. If alarms occur at a rate less 
  196.       than the time-out period, the HP 48 will always be on. If anything is 
  197.       being done when the alarm occurs, the alarm will either not process 
  198.       immediately (when a program is running, the alarm doesn't process until 
  199.       the program terminates), or it will abort what is happening (edits will
  200.       be terminated as if the [ATTN] key had been pressed).
  201. -------------------------------------------------------------------------------
  202.  
  203.       
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.